docs: Fix up the 3-to-4 migration guide

docs: Add backend links to the gdk docs

These are placeholders for when we know how to
link across namespaces.

docs: Add separate toml files for gdk backends

Reusing the same one duplicates the standalone
docs, which doesn't quite seem right.

docs: Brush up the Wayland backend docs

Add some content here.

gdk: Some more tweaks of the docs

docs: Add some links to the pango chapter

docs: Rework the gdk docs

Convert links, make things more concise.

docs: Move GdkEvent docs inline

This is not really worth a chapter of its own.

docs: Improve gsk docs

Convert link formats, add summaries, and make
a few missing things show up in the docs.

docs: Tweak X11 section

Remove unsupported heading anchors.

docs: Tweaks Windows section

Remove unsupported heading anchors.

docs: Tweak Wayland section

Remove unsupported heading anchors.

docs: Tweak a11y section

Convert link syntax.

docs: Tweak running chapter

Remove unsupported heading anchors, fix definition
list use.

docs: Tweak input overview

Remove unsupported heading anchors.

docs: Tweak drawing model overview

Fix link syntax, remove gtk-doc markup.

docs: Tweak css properties section

Fix the use of definition lists.

docs: Tweak the actions overview

Fix use of definition lists, and remove some gtk-doc
markup.

building: Minor tweaks

Remove unsupported anchors from headings.

video: Convert docs

Change link syntax, add an example image, generally clean things up.

glarea: Convert docs

Change link syntax, add an example image, generally clean things up.

drawingarea: Convert docs

Change link syntax, add an example image, generally clean things up.

textview: Convert docs

Change link syntax, add an example image, generally clean things up.

picture: Convert docs

Change link syntax, add an example image, generally clean things up.

scale: Convert docs

Change link syntax, add an example image, generally clean things up.

image: Convert docs

Change link syntax, add an example image, generally clean things up.

separator: Convert docs

Change link syntax and add an example image.

calendar: Convert docs

Change link syntax, add an example image, generally clean things up.

scrollbar: Convert docs

Change link syntax, add an example image, generally clean things up.

infobar: Convert docs

Change link syntax, add an example image, generally clean things up.

docs: Generate the DevHelp file for our namespaces

docs: Update the "Getting Started" page

Drop the Pandoc stuff, add the gi-docgen links, and remove a stray
docbook element.

statusbar: Convert docs

Change link syntax, add an example image, generally clean things up.

infobar: Convert docs

Change link syntax, add an example image, generally clean things up.

progressbar: Convert docs

Change link syntax, add an example image, generally clean
things up.

levelbar: Convert docs

Change link syntax, add an example image, generally
clean things up.

spinner: Convert docs

Change link syntax and add an example image.

aboutdialog: tweak the docs

Add a short summary.

label: Convert docs

Change link syntax, add singl-line summaries,
add missing property docs.

docs: Bring the widget gallery back

We have all the images, lets put them to use.

docs: Remove the last few remaining '+' from GTK

docs: Clean up the first paragraph for various symbols

The documentation engine will use the first paragraph as the summary for
a type or constant.

docs: Show summary in the namespace index

docs: Start porting GtkImage to the new style

docs: Port GtkAboutDialog to the new syntax

We should also clean up the annotations, while we're at it.

build: Quiet down gi-docgen

We are only interested in the warnings and errors.

docs: Fix up the style of the X11 content file

docs: Move detached sections into their own content file

docs: Split GdkDrag and GdkDrop sections

This way we have a section for each class.

docs: Rename GdkTexture section

The name needs to match the class.

docs: Move gdkcairo section to an external file

docs: Move the gtkmain section to its own document

The introspection data does not handle unattached sections like gtk-doc
does, so we need to move what was gtkmain into its own Markdown
document.

docs: Use new link syntax

docs: Begin porting GtkWidget to the new format

doc: Port GtkConstraint to the new format

docs: De-indent GtkRecentInfo.get_applications() return value

Otherwise the four spaces will be treated as a pre-formatted block by
Markdown.

docs: Start porting GtkConstraintLayout to the new doc format

Drop the old gtk-doc'isms, and use the gi-docgen links instead.

docs: Add metadata preamble to GTK's content files

docs: Drop gtk-doc files

We don't use gtk-doc to generate our API reference, so we don't need its
files lying around any more.

Generate GTK API reference(s) with gi-docgen

Stop using gtk-doc, and switch to gi-docgen.

The gi-docgen tool generates API references through the introspection
data, which has various benefits:

 - it does not parse C code
 - it does not generate and run C code to introspect types at build time
 - it does not present a different API from the one we're exporting

Additionally, gi-docgen:

 - does not generate DocBook XML in order to generate HTML
 - does not go through xsltproc
 - parses proper Markdown

Which makes it markedly faster than gtk-doc has ever been.

Add gi-docgen as a subproject

While we're developing gi-docgen it's better to have it as part of our
build.

ci: Update the fedora-docs Docker image

Use the latest base image.

ci: Update the CI image for docs building

We don't use Pandoc any more, but we need a bunch of Python modules for
gi-docgen.

ci: Update the reference job

Rename base version argument in run-docker.sh

The `--base-version` argument trips up everyone. Might as well rename it
to `--version`.

Merge branch 'fix-menubutton-tooltips' into 'master'

Limit tooltip queries to the same native

Closes #3719

See merge request GNOME/gtk!3283

Limit tooltip queries to the same native

Without this, the menubuttons tooltip pops up
when hovering the popover, which is suprising
and unintended.

Fixes: #3719

Merge branch 'gdk-win32-use-window-from-point-for-master' into 'master'

GdkWin32: Fix mouse events in presence of transparent windows on the desktop

Closes #370, #417, and gimp#1082

See merge request GNOME/gtk!2800

Merge branch 'matthiasc/for-master' into 'master'

inspector: Fix surface transform regression

See merge request GNOME/gtk!3280

inspector: Fix surface transform regression

Ever since we added surface-to-widget transforms,
the autofading of the fps overlay did not work anymore,
since it was given the transient transform node, most
of the time.

Fix this by passing both the root of the node tree and
the node for the toplevel widget to prepare_render, and
hande the widget node to the overlays. Update the
affected overlays that need to have their positioning
adjusted.

Update Serbian translation

(cherry picked from commit f33a2febc7df6ec9c7721361f94121c2db079057)

Merge branch 'wip/otte/for-master' into 'master'

Wip/otte/for master

See merge request GNOME/gtk!3279

wayland: Fix memleaks when rendering with Cairo

We were leaking buffers. This wasn't caught by valgrind and friends
because it was shared memory (with the compositor), but top(1) would
instantly see memory consumption of the app and the shell go through the
roof.

wayland: Don't call _gdk_surface_update_size() all the time

We were calling _gdk_surface_update_size() every frame, even if the
window size didn't change. This would cause us to discard all cached
buffers and redraw the whole screen.

This was BAD.

Merge branch 'ngl-rect-borders' into 'master'

Speed up border rendering

See merge request GNOME/gtk!3278

nodeparser: Print debug message before child

This puts the message up top, where it can be seen,
and not at the other end of an endless tree of children.

Update tests to match.

ngl: Render simple borders simply

Use 4 color commands for uniform, rectilinear
borders. Most of our borders are rounded with
Adwaita, but there are still some of these.

gsk: Add gsk_border_node_get_uniform_color

Maintain this bit of information separately,
it will be useful in the next commit.

vulkan: Improve rounded rect clipping

Handle the case where the inner rounded rect is fully contained
within the outer rounded rect.

vulkan: Fix invalid read

Look at the right rect to compute circularness

Merge branch 'meson-override-dep' into 'master'

meson: override gtk4 dependency

See merge request GNOME/gtk!3277

meson: override gtk4 dependency

This allows applications that depends on gtk4 to build it as subproject
without hardcoding 'gtk_dep' variable name in their build definition.

Merge branch 'matthiasc/for-master' into 'master'

Matthiasc/for master

See merge request GNOME/gtk!3276

Merge branch 'bilelmoussaoui/size-request-annotations' into 'master'

g-i: update distribute_natural_allocation annotation

See merge request GNOME/gtk!3271

node-format: Small docs fixes

spinbutton: Interpret localized digits

Interpret input where the characters have numeric values.

See #3387

Merge branch 'ngl-clip-classification' into 'master'

Ngl clip classification

See merge request GNOME/gtk!3274

glsl: Make rounded rect clipping cheaper

Add early acceptance checks for non-corner cases.

Merge branch 'matthiasc/for-master' into 'master'

Revert "ngl: Remove a few redundant checks"

See merge request GNOME/gtk!3273

Revert "ngl: Remove a few redundant checks"

This reverts commit 4375f8e382ef035d970dd255f56d1a7470c1a78c.

These were not redundant after all, as pointed out by Timm.

Add some more rounded rect tests

gsk: Use clip defines in shaders

Use the NO_CLIP and RECT_CLIP defines to make
simpler shaders for these cases.

Note: This does not work yet.

ngl: Add infrastructure for clip-variants of shaders

Make ngl compile each shader three times.
Once with #define NO_CLIP 1
once with #define RECT_CLIP 1
and once as before.

ngl: Classify clips

Maintain the 'fully contained' information in the clip
stack. This will let us pick simpler shaders in the future.

Merge branch 'ebassi/iface-macros' into 'master'

Remove invalid class macros

See merge request GNOME/gtk!3270

Move gtk_rounded_rect_scale_affine to the right place

This function should live with the rest of the
GskRoundedRect code in gskroundedrect.c.

imcontext: Fix a docs mishap

g-i: update distribute_natural_allocation annotation

Merge branch 'bilelmoussaoui/gi-annotations' into 'master'

g-i: add missing since annotations for 4.2

See merge request GNOME/gtk!3268

g-i: add missing since annotations for 4.2